Manager: Control Manager


Carbon will fully support the Control Manager, with the following changes:

* The C-style, lowercase versions of Control Manager function names are no longer supported. If your application uses any Control Manager lowercase function names, you must replace them with their uppercase equivalents.

* Custom control definition procedures (also known as CDEFs), must be compiled as PowerPC-native code, and can not be stored as resources. See the Carbon Porting Guide for more information.

* Your application must use the functions defined by the Control Manager whenever your application needs to create and dispose of Control Manager data structures. For example, instead of directly creating and disposing of control records, applications must call the Control Manager functions GetNewControl and DisposeControl.

* Your application must use Control Manager accessor functions to accesses Control Manager data structures.

* You are encouraged to adopt the standard Mac OS control definition procedures in your application. Applications that use the standard control definition procedures inherit the Mac OS human interface appearance. Applications that use custom control definition procedures will work correctly, but because custom definition procedures invoke their own drawing routines, Mac OS 8 can't draw these applications with the current appearance.

Supported  ActivateControl

Supported  AdvanceKeyboardFocus

Supported  AutoEmbedControl

Supported  CallControlActionProc

Supported  CallControlDefProc

Supported  CallControlEditTextValidationProc

Supported  CallControlKeyFilterProc

Supported  CallControlUserPaneActivateProc

Supported  CallControlUserPaneBackgroundProc

Supported  CallControlUserPaneDrawProc

Supported  CallControlUserPaneFocusProc

Supported  CallControlUserPaneHitTestProc

Supported  CallControlUserPaneIdleProc

Supported  CallControlUserPaneKeyDownProc

Supported  CallControlUserPaneTrackingProc

Supported  ClearKeyboardFocus

Supported  ControlActionProcPtr

Supported  ControlDefProcPtr

Supported  ControlEditTextValidationProcPtr

Supported  ControlKeyFilterProcPtr

Unsupported  ControlNotificationProcPtr

QuickTime control notification functions are not supported in Carbon.

Supported  ControlUserPaneActivateProcPtr

Supported  ControlUserPaneBackgroundProcPtr

Supported  ControlUserPaneDrawProcPtr

Supported  ControlUserPaneFocusProcPtr

Supported  ControlUserPaneHitTestProcPtr

Supported  ControlUserPaneIdleProcPtr

Supported  ControlUserPaneKeyDownProcPtr

Supported  ControlUserPaneTrackingProcPtr

Supported  CountSubControls

Supported  CreateRootControl

Supported  DeactivateControl

Supported  DisposeControl

Supported  DisposeControlActionUPP

Supported  DisposeControlDefUPP

Supported  DisposeControlEditTextValidationUPP

Supported  DisposeControlKeyFilterUPP

Supported  DisposeControlUserPaneActivateUPP

Supported  DisposeControlUserPaneBackgroundUPP

Supported  DisposeControlUserPaneDrawUPP

Supported  DisposeControlUserPaneFocusUPP

Supported  DisposeControlUserPaneHitTestUPP

Supported  DisposeControlUserPaneIdleUPP

Supported  DisposeControlUserPaneKeyDownUPP

Supported  DisposeControlUserPaneTrackingUPP

Supported  DragControl

Unsupported  dragcontrol

Use DragControl instead.

Supported  Draw1Control

Supported  DrawControlInCurrentPort

Supported  DrawControls

Supported  DumpControlHierarchy

Supported  EmbedControl

Supported  FindControl

Unsupported  findcontrol

Use FindControl instead.

Supported  FindControlUnderMouse

Supported  GDBShowControlHierarchy

Supported  GDBShowControlInfo

Supported  GetAuxiliaryControlRecord

Supported  GetBestControlRect

Supported  GetBevelButtonContentInfo

Supported  GetBevelButtonMenuHandle

Supported  GetBevelButtonMenuValue

Supported  GetControl32BitMaximum

Supported  GetControl32BitMinimum

Supported  GetControl32BitValue

Supported  GetControlAction

Supported  GetControlBounds

Unsupported  GetControlColorTable

Custom control color tables are not supported in Carbon.

Unsupported  GetControlComponentInstance

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  GetControlData

Supported  GetControlDataHandle

Supported  GetControlDataSize

Supported  GetControlDefinition

Supported  GetControlFeatures

Unsupported  GetControlHandleFromCookie

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  GetControlHilite

Supported  GetControlMaximum

Supported  GetControlMinimum

Supported  GetControlOwner

Unsupported  GetControlOwningWindowControlList

Supported  GetControlPopupMenuHandle

Supported  GetControlPopupMenuID

Supported  GetControlProperty

Supported  GetControlPropertySize

Supported  GetControlReference

Supported  GetControlRegion

Supported  GetControlTitle

Unsupported  getcontroltitle

Use GetControlTitle instead.

Supported  GetControlValue

Supported  GetControlVariant

Supported  GetControlViewSize

Supported  GetImageWellContentInfo

Supported  GetIndexedSubControl

Supported  GetKeyboardFocus

Supported  GetNewControl

Unsupported  GetNextControl

The GetNextControl function is not supported in Carbon. Use the Control Manager's embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  GetRootControl

Supported  GetSuperControl

Supported  GetTabContentRect

Supported  HandleControlClick

Supported  HandleControlKey

Supported  HideControl

Supported  HiliteControl

Supported  IdleControls

Supported  InvokeControlActionUPP

Supported  InvokeControlDefUPP

Supported  InvokeControlEditTextValidationUPP

Supported  InvokeControlKeyFilterUPP

Supported  InvokeControlUserPaneActivateUPP

Supported  InvokeControlUserPaneBackgroundUPP

Supported  InvokeControlUserPaneDrawUPP

Supported  InvokeControlUserPaneFocusUPP

Supported  InvokeControlUserPaneHitTestUPP

Supported  InvokeControlUserPaneIdleUPP

Supported  InvokeControlUserPaneKeyDownUPP

Supported  InvokeControlUserPaneTrackingUPP

Supported  IsControlActive

Supported  IsControlHilited

Supported  IsControlVisible

Supported  IsValidControlHandle

Supported  KillControls

Supported  MoveControl

Supported  NewControl

Unsupported  newcontrol

Use NewControl instead.

Supported  NewControlActionProc

Supported  NewControlActionUPP

Supported  NewControlDefProc

Supported  NewControlDefUPP

Supported  NewControlEditTextValidationProc

Supported  NewControlEditTextValidationUPP

Supported  NewControlKeyFilterProc

Supported  NewControlKeyFilterUPP

Supported  NewControlUserPaneActivateProc

Supported  NewControlUserPaneActivateUPP

Supported  NewControlUserPaneBackgroundProc

Supported  NewControlUserPaneBackgroundUPP

Supported  NewControlUserPaneDrawProc

Supported  NewControlUserPaneDrawUPP

Supported  NewControlUserPaneFocusProc

Supported  NewControlUserPaneFocusUPP

Supported  NewControlUserPaneHitTestProc

Supported  NewControlUserPaneHitTestUPP

Supported  NewControlUserPaneIdleProc

Supported  NewControlUserPaneIdleUPP

Supported  NewControlUserPaneKeyDownProc

Supported  NewControlUserPaneKeyDownUPP

Supported  NewControlUserPaneTrackingProc

Supported  NewControlUserPaneTrackingUPP

Unsupported  PreFilterEventProc

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  RemoveControlProperty

Supported  ReverseKeyboardFocus

Supported  SendControlMessage

Supported  SetBevelButtonContentInfo

Supported  SetBevelButtonGraphicAlignment

Supported  SetBevelButtonMenuValue

Supported  SetBevelButtonTextAlignment

Supported  SetBevelButtonTextPlacement

Supported  SetBevelButtonTransform

Supported  SetControl32BitMaximum

Supported  SetControl32BitMinimum

Supported  SetControl32BitValue

Supported  SetControlAction

Supported  SetControlBounds

Unsupported  SetControlColor

Custom control color tables are not supported in Carbon.

Unsupported  SetControlColorTable

Custom control color tables are not supported in Carbon.

Supported  SetControlData

Supported  SetControlDataHandle

Unsupported  SetControlDefProc

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  SetControlFontStyle

Supported  SetControlMaximum

Supported  SetControlMinimum

Supported  SetControlOwner

Supported  SetControlPopupMenuHandle

Supported  SetControlPopupMenuID

Supported  SetControlProperty

Supported  SetControlReference

Supported  SetControlSupervisor

Supported  SetControlTitle

Unsupported  setcontroltitle

Use SetControlTitle instead.

Supported  SetControlValue

Supported  SetControlViewSize

Supported  SetControlVisibility

Supported  SetDisclosureTriangleLastValue

Supported  SetImageWellContentInfo

Supported  SetImageWellTransform

Supported  SetKeyboardFocus

Unsupported  SetNextControl

The SetNextControl function is not supported in Carbon. Use the Control Manager's embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  SetTabEnabled

Supported  SetUpControlBackground

Supported  SetUpControlTextColor

Supported  ShowControl

Supported  SizeControl

Supported  TestControl

Unsupported  testcontrol

Use TestControl instead.

Supported  TrackControl

Unsupported  trackcontrol

Use TrackControl instead.

Supported  UpdateControls

[Table of Contents] [Manager Index] [Function Index]

Generated on: 7/7/99. Copyright 1999 Apple Computer, Inc. All rights reserved.